home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Desktop Improver / NewEdit 1.15 / NewEdit.doc < prev    next >
Text File  |  1996-09-26  |  9KB  |  263 lines
  1.  
  2.  
  3.                                  NewEdit V1.15
  4.  
  5.                           (c) 1992-1995 by  Uwe Roehm
  6.  
  7.  
  8.  
  9.  
  10.  Goal
  11. ======
  12. NewEdit is a commodity that improves the functionality of each string gadget
  13. in the system. Beside some new edit functions (see below) NewEdit offers copy
  14. and paste of text between the clipboard and string gadgets!
  15.  
  16. Short:
  17.   - Improves all string gadgets with
  18.      - word for word movement and deletion,
  19.      - changing between different string gadgets via cursor keys,
  20.      - ESCape = cancel,
  21.      - copy and paste between clipboard and string gadgets,
  22.      - mathematical calculations,
  23.      - insertion of date and time,
  24.      - case toggling of characters and
  25.      - in- and decresement od numbered file names.
  26.   - Commodity
  27.   - Options (Workbench and Shell)
  28.   - Support for different keymaps
  29.   - Support for locale.library
  30.  
  31.  
  32.  Copyright
  33. ===========
  34. NewEdit is based on a program by Oliver Wagner (published on the german
  35. AmigaPlus disk 9/92). The current version 1.15 is an enhancement of 
  36. NewEdit V1.6, that is available on AmigaPlus disk 1/93. 
  37. NewEdit V1.15 is FreeWare!
  38.  
  39. There's also a second branch of NewEdit's development starting with V1.8,
  40. of which Paul Huxham released several improved versions. To avoid any 
  41. irritations I decided to include all his functions and to follow his
  42. version numbers.
  43.  
  44.  
  45.  Systemrequirements
  46. ====================
  47. NewEdit works on all Amiga computers with at least AmigaOS 2.04.
  48. Other languages are supported starting with AmigaOS 2.1 (the locale.library
  49. is needed). For the evaluation of mathematical expressions the
  50. calculus.library is used which can be found e.g. on Aminet.
  51.  
  52.  
  53.  Installation
  54. ==============
  55. Copy NewEdit and its documentation into any directory you want. If you
  56. want to start automatically at boot time I recommend to put it into
  57. "Sys:WBStartup/". For the evaluation function the "calculus.library"
  58. is needed in "libs:", also NewEdit also works without this library.
  59.  
  60. Since version 1.15 there's also an installer script which will do
  61. all the work for you to install and even to configure NewEdit. Enjoy.
  62.  
  63.  
  64.  Programstart and -end
  65. =========================
  66. NewEdit can be launched from a shell or the workbench and installs its own
  67. global stringhook instead of the original Intuition-hook. You can terminate
  68. it pressing CONTROL-C or by starting NewEdit again.
  69.  
  70. As NewEdit 1.15 is a commodity, which is known by commodities.library, you can
  71. also in-/activate it from within Commodore's ExChange program.
  72.  
  73.  
  74.  Configuration
  75. ===============
  76. There are ten options available both for the start from a shell or from
  77. workbench (as icon tooltypes):
  78.  
  79.   CLIPUNIT  Specifies the unit of the clipboard used by NewEdit for the
  80.             copy/paste operation. Default: 0.
  81.  
  82.   NOALT     Tells NewEdit to ignore the right Alt key as qualifier for 
  83.             commands (copy, paste, evaluate, date, time, case, filenumber).
  84.             This is useful if some of the key combinations are already used
  85.             by other tools.
  86.  
  87.   NOAMIGA   Same as NOALT, but doen't use the right Amiga key as qualifier.
  88.  
  89.   NOCONTROL Disables the commands which are introduced by the Control-key.
  90.  
  91.   NOESC     Disables the exiting of string gadgets via the Escape-key.
  92.  
  93.   CALCKEY   Specifies the character which starts the evaluation of the
  94.             string gadget's contents as mathematical expression. Must
  95.             be pressed together with the right Alt or right Amiga key
  96.             which can not be altered.
  97.  
  98.   CASEKEY   Specifies the character which toggles the case of the current
  99.             character/word. Must be pressed together with the right Alt
  100.             or right Amiga key which can not be altered.
  101.  
  102.   COUNTKEY  Specifies the character which increases/decreases the count
  103.             of a numbered file name. Must be pressed together with the 
  104.             right Alt or right Amiga key which can not be altered.
  105.  
  106.   DATEKEY   Specifies the character which inserts the current date into
  107.             a string gadget. Must be pressed together with the 
  108.             right Alt or right Amiga key which can not be altered.
  109.  
  110.   TIMEKEY   Specifies the character which inserts the current time into
  111.             a string gadget. Must be pressed together with the 
  112.             right Alt or right Amiga key which can not be altered.
  113.  
  114.  
  115.  
  116.  Functions
  117. ===========
  118. Cursormovements
  119.    Alt Cursor Left        Move to start of previous word
  120.    Alt Cursor Right       Move to start of next word
  121.    Alt Backspace          Delete previous word
  122.    Alt Delete             Delete next word
  123.    Control d              Delete current character
  124.    Control e              Jump to end of line
  125.  
  126. Activation
  127.    Escape                 Synonym for RETURN Key         (accepting contents)
  128.    Right Alt Cursor Up    Activate previous stringgadget (        -"-       )
  129.    Right Alt Cursor Down  Activate next stringgadget     (        -"-       )
  130.  
  131. Clipboard
  132.    Right Alt or Amiga c   Copy text from stringgadgets into clipboard
  133.    Right Alt or Amiga v   Insert text from clipboard at current cursorposition
  134.  
  135. Evaluation
  136.    Right Alt or Amiga e   Treats the string gadget's contents as mathematival
  137.                           expression, evaluates it and replaces it with its 
  138.                           result using the calculus.library (see below).
  139.  
  140. Time/Date
  141.    Right Alt or Amiga t   Insert actual time
  142.    Right Alt or Amiga d   Insert current date
  143.  
  144. Case-Toggling
  145.    Right Alt or Amiga g   Toggle case of current character
  146.    Shift right Alt g or   Toggle case until end of line or next non-alphabetic char
  147.    Shift right Amiga g
  148.  
  149. Filenumbering
  150.    Right Alt or Amiga i   Increase number of a numbered filename by one
  151.    Shift right Alt i or   Decrease filename's number by one
  152.    Shift right Amiga i
  153.  
  154. All original edit functions remain the same:
  155.    Cursor Left            Move to previous character
  156.    Cursor Right           Move to next character
  157.    Shift Cursor Left      Move to start of line
  158.    Shift Cursor Right     Move to end of line
  159.    Delete                 Delete character under cursor
  160.    Shift Delete           Delete until end of line
  161.    Backspace              Delete character left of cursor
  162.    Shift Backspace        Delete up to start of line
  163.    Control a              Jump to start of line
  164.    Control y              Delete until end of line
  165.    Right Amiga Q          Undo
  166.    Right Amiga X          Clear all
  167.    Return or Enter        Accept contents and finish input
  168.  
  169.  
  170.  Author
  171. ========
  172. You can reach me for bug reports or suggestions as follows:
  173.  
  174.   EMail: NewEdit@roemer.deg.sub.org
  175.   Fido:  Uwe Röhm, 2:2494/22.5
  176.  
  177.  
  178.  Greetings
  179. ===========
  180. Rene Beaupoil   for working on my article in AmigaPlus
  181. Stefan Becker   don't remember for what exactly but thanks ;-)
  182. Stefan Stuntz   for some code in MUI to support NewEdit
  183. Paul Huxham     for a hell of improvements and his programming 
  184.                 while I was busy with university
  185. David Göhler    for beeing himself and extoling his calculus.library to me
  186.  
  187.  
  188. calculus.library
  189. ================
  190. The calculus.library (© 1995 by David Göhler) is a small shared
  191. library which evaluates INTEGER (!) expressions. The current version
  192. is included in this distribution, newer version might be available in
  193. Aminet in the "dev/misc" directory. The author of this library is:
  194.  
  195.    David Göhler
  196.    Dorfstr. 51 a
  197.    85591 Vaterstetten
  198.    Germany
  199.    email: david@mail.magna.de
  200.  
  201. The library supports the following operators:
  202.  
  203.   +       add
  204.   -       substracte
  205.   *       multiply
  206.   /       divide
  207.   div     divide
  208.   ^       power
  209.   mod     modulus operation
  210.   &       bitwise and
  211.   |       bitwise or
  212.   xor     bitwise exclusive or
  213.   ~       bitwise not
  214.   -       negate
  215.   lsh     shift left
  216.   rsh     shift right
  217.   eqv     equal?
  218.   =       equal?
  219.   <       less (does not work on normal shells)
  220.   >       greater (does not work on normal shells)
  221.  
  222.  You can use ( and ) for grouping numbers. The power
  223.  operator has not (!) a higher priority than *, /, div and
  224.  mod!
  225.  
  226.  But *, /, div and mod have a higher priority than + and -
  227.  
  228.  
  229.  
  230.  History
  231. =========
  232. NewEdit 1.15
  233.  - NEW: Options NOCONTROL, NOESC, CALCKEY, CASEKEY, COUNTKEY,
  234.                 DATEKEY and TIMEKEY
  235.  - NEW: Control-d and Control-e commands
  236.  - NEW: Support for different keymaps
  237.  - NEW: German AmigaGuide
  238.  - NEW: Installer script
  239.  - source improved
  240.  
  241. NewEdit 1.11 (not released - Paul was faster ;-)
  242.  - NEW: Included improvements of Paul Huxham.
  243.  - NEW: Evaluation of mathematical expressions via "calculus.library"
  244.  - NEW: Options CLIPUNIT, NOALT and NOAMIGA
  245.  - Source cleaned up
  246.  - improved Texts
  247.  - compiled with SAS/C 6.55
  248.  
  249. NewEdit 1.8b, 1.9, 1.10 and 1.14
  250.  - improved Versions by Paul Huxham
  251.  
  252. NewEdit 1.9 (not released)
  253.  - now english as default language
  254.  - compiled with SAS/C 6.51
  255.  
  256. NewEdit 1.8
  257. NewEdit 1.7
  258.  - bugfixes
  259.  
  260. NewEdit 1.6
  261.  First public release via AmigaPlus magazin 1/93
  262.  
  263.